CS-ClientTestConsole¶
Введение¶
Консольная и кросплатформенная версия программы ClientTest
. Предназначена для проверки подключений, чтения и записи показаний. Может работать с датасервером, НСИ и архивом.
Программа имеет консольный GUI, и в качестве конфигурации может использовать как конфигурационный файл от ClientTest3
, так и параметры командной строки(что предпочтительнее)
Использует .Core 2.1 для работы, поэтому представляет собой dll-файл, для запуска которого нужно передать путь к файлу утилите dotnet
.
Установка¶
Для запуска программы требуется .Core 2.1. Необходимые компоненты можно найти на оффициальном сайте Microsoft:
Windows: https://docs.microsoft.com/ru-ru/dotnet/core/windows-prerequisites?tabs=netcore2x
Linux: https://docs.microsoft.com/ru-ru/dotnet/core/linux-prerequisites?tabs=netcore2x
Для Linux достаточно установить набор библиотек dotnet-runtime-2.1 (Для ubuntu и mint 19: https://dotnet.microsoft.com/download/linux-package-manager/ubuntu19-04/runtime-current)
Запускается через утилиту dotnet в командной строке/консоли.
Все даты используют UTC.
Настройка¶
В среде windows программа использует файл конфигурации от графической версии, который расположен в следующем пути: %APPDATA%\Delta\d8_clienttest3.settings.xml
или в папке с исполняемым файлом
Более предпочтительнее(а в unix системах фактически единственный) способ запуска с использованием параметров командной строки.
Поддерживаются следующие параметры:
-
client
- строка параметров соединения, -
paramdb
- строка соединения c базой данных, содержащей справочную информацию о параметрах, -
archdb
- строка соединения с архивной базой данных. -
login
- логин, -
pass
- пароль, -
win_auth
- значения "t", "true", "yes", "y", "1" указывают на использование windows-авторизации, -
gen_rate
- период генерации значений в секундах, -
instancetype
- название типа используемого инстанса(по умолчанию D8RegularInstance) реализующего ID8Instance2. Библиотека, содержащая реализацию, должна находиться в папке с приложением. -
improvedgen
- значения "t", "true", "yes", "y", "1" указывают на использование генератора учитывающего допустимые диапазоны значений параметров -
showcolumns
- список отображаемых столбцов, разделяемый символом ";". Если пустой или отсутствует - отображаются все. Возможные столбцы: Id, Type, Name, Value, Timestamp, State, XState, TimeRange, GetValueCounter, LastSetValueTime
Пример:dotnet cs_clienttestconsole_core.dll "client=serveraddr=127.0.0.1;serverport=5001" "paramdb=Provider=SQLNCLI11; Initial Catalog=DEMO;data source=127.0.0.1" login=rw pass=psw "archdb=Provider=SQLNCLI11; Initial Catalog=DEMO_DATA;data source=127.0.0.1" win_auth=f instancetype=D8RegularInstance showcolumns=Id;Name;Value
Интерфейс¶
Программа состоит из 3 основных экранов:
Работа с датасервером(текущие значения) - Current Values
Архивные значения всех параметров на указанную дату - Archive Values
Архивные значения заданного параметра в заданный период - Archive value ID
Каждый экран состоит из двух частей: показания(верхняя), и список сообщений(нижняя).
Так же, на всех трех экранах можно вызвать справку нажатием клавиши F1
, где будет указан список доступных функций и клавиш для их вызова
Перелистывать страницы позволяют клавиши
Page Up\Page Down
.
F4
- прочитать все значения архива на заданную датуF5
- прочитать все значения параметра в заданный период (может быть так же вызвана черезEnter
для выделенного параметра)F6
- вызвать меню записи значения параметра
F2
- включить генерацию значений для выделенного параметраCtrl+F2
- включить генерацию значений для всех параметровF3
- остановить генерацию значенийCtrl+F3
- остановить генерацию значений для всех параметровF7
- блокирование параметраF8
- разблокирование параметраF9
- квитирование параметраF10
- сохранить настройки (сохраняются настройки, переданные через параметры командной строки, исключение - пароль)
Нажатием клавиши Esc
можно вернуться на главный экран из экранов архива, выйти из программы или отменить текущее действие (отправка данных, ввод даты и т.д.)
Меню записи значения параметра
Внимание: если меню было вызвано из экрана "Текущие значения", данные будут отправляться дата-серверу, иначе - в архив.
Использование клавиши "Tab" позволяет перемещать фокус ввода с одного поля на другое в порядке сверху вниз.
В момент перелистывания параметров проверяется правильность заполнения текущего.
После заполнения всех полей данные отправляются нажатием клавиши Enter.
Для редактирования поля State нажмите пробел, после чего откроется окно.
Переключение флага Save осуществляется нажатием пробела.
В верхней части этого окна указан список используемых флагов. По умолчанию это save.
[ДОБАВИТЬ] - добавить флаг состояния. При этом открывается список флагов, который можно листать клавишами Page Up/Page Down, а выбрать нужный клавишами-стрелками, после чего нажать ENTER для подтверждения, или ESC для отмены
Сохранить: [X] - "чекбокс" для выбора установить флаг save или нет
[ОЧИСТИТЬ] - очистить флаги состояния (не влияет на флаг save)
[ПОДТВЕРДИТЬ] - подтвердить использование заданного состояния (Esc - отмена)
История версий¶
1.1.21.0818
- Добавлена возможность генерировать несколько параметров
- Добавлена русская локализация и поддержка нескольких локализаций
- Мелкие исправления, связанные со слишком маленьким размером окна
1.1.19.0930
- Добавлена возможность задать флаг состояния параметра при отправке.
- Мелкие исправления.
1.1.19.0917
- Первая версия.